home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 021a / convrt12.zip / CONVERT.DOC < prev    next >
Text File  |  1991-10-26  |  9KB  |  265 lines
  1.  
  2.  
  3. **************************
  4. *                        *
  5. *   C O N V E R T v1.2   *
  6. *   Copyright (c) 1991   *
  7. *   by -Mate Software    *
  8. *                        *
  9. **************************
  10.  
  11.  
  12.  
  13. DISCLAIMER OF WARRANTY:
  14. -----------------------
  15.  
  16. THIS SOFTWARE AND MANUAL ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND,
  17. EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  18. WARRANTIES OF MERCHANTABILITY AND FITNESS OF PURPOSE.  THE USER OF THIS
  19. SOFTWARE AND MANUAL ASSUMES ALL RISKS.
  20.  
  21.  
  22.  
  23. INTRODUCTION:
  24. -------------
  25.  
  26. Unmodified copies of this program and the accompanying documentation may be
  27. made and distributed freely without charge.  Under no circumstances shall
  28. this program or the accompanying documentation be distributed as part of any
  29. for-profit venture, without expressed written permission from the author.
  30.  
  31. CONVERT takes a coordinate data file in a specific format and converts it
  32. into an AutoCAD DXF file which can then be used as a starting point for a
  33. site plan or topographic drawings.  Optionally, AutoCAD blocks may be
  34. inserted at specific point locations, and feature lines may be drawn,
  35. connecting specific points in the coordinate data file.
  36.  
  37.  
  38.  
  39. GENERAL REQUIREMENTS:
  40. ---------------------
  41.  
  42. The following files are required in order for CONVERT to function properly:
  43.  
  44.      CONVERT.EXE
  45.      CODES.DAT
  46.      <YOUR COORDINATE DATA FILE>
  47.  
  48. In order for CONVERT to execute properly, and utilize the information in the
  49. file "CODES.DAT",  "CODES.DAT" must be in the current sub-directory when
  50. CONVERT is executed.
  51.  
  52.  
  53.  
  54. INSTRUCTIONS FOR RUNNING CONVERT:
  55. ---------------------------------
  56.  
  57. First create a sub-directory on your hard disk for convert (ie: C:\CONVERT),
  58. then copy the files from the archive or distribution diskette into that
  59. sub-directory.  In order for CONVERT to work properly, you must run it from
  60. the sub-directory into which you have copied it.
  61.  
  62.  
  63.        C O N V E R T v1.2             Copyright (c) 1991 by -Mate Software
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. To execute CONVERT, simply type "CONVERT" and press [Enter].  CONVERT will
  71. prompt you for an input data file, at which point you should enter the name
  72. of the coordinate data file that you wish to convert into a DXF points file.
  73. You may enter a full drive, path, filename combination at this prompt.  Next,
  74. CONVERT will prompt you for a drawing scale.  At this point, it should be
  75. noted that CONVERT dose NOT scale the points plot.  Everything plotted by
  76. CONVERT is plotted on the drawing at 1=1, and at the correct northing (y-
  77. coordinate) and easting (x-coordinate).  CONVERT uses the supplied scale only
  78. to scale the printed point numbers and point reference circles.  The next
  79. prompt asks if you want to plot the AutoCAD blocks referenced in the
  80. "CODES.DAT" file.  If you answer "Y" to this prompt, CONVERT will plot any
  81. AutoCAD blocks referenced in the "CODES.DAT" file that correspond to codes
  82. specified in the coordinate data file.  The final prompt offers you the
  83. option of specifying a feature line file defining points that you wish to be
  84. connected by feature lines.
  85.  
  86. Detailed information and coding instructions on the files used by CONVERT are
  87. included in the following sections.
  88.  
  89.  
  90.  
  91. COORDINATE DATA FILE REQUIREMENTS:
  92. ----------------------------------
  93.  
  94. The coordinate data file should be in the following format with the fields
  95. separated by one or more spaces:
  96.  
  97.      <POINT NO.> <NORTHING> <EASTING> <ELEVATION> <CODE> <REMARKS>
  98.  
  99. All input values except <REMARKS> must me numeric.  The value entered in the
  100. <CODE> field is used to determine the AutoCAD layer that the point will be
  101. plotted on, as well as the AutoCAD block (if any) that will be plotted at
  102. that particular point.  <REMARKS> may be any character/numeric combination,
  103. and is ignored by CONVERT.  Any lines in the coordinate data file that do not
  104. conform to the above requirements are also ignored by CONVERT.  Therefore, it
  105. is not usually necessary to remove extra lines from a coordinate data file
  106. generated by a survey data collector or other source before running CONVERT,
  107. as long as the required information is in the correct format.  A typical
  108. coordinate data file is included in the archive or on the distribution
  109. diskette.
  110.  
  111.  
  112.  
  113. "CODES.DAT" REQUIREMENTS:
  114. -------------------------
  115.  
  116. CONVERT reads the file "CODES.DAT" upon execution, and uses the information
  117. contained in this file to determine the AutoCAD layers that the points will
  118. be plotted on, and the AutoCAD blocks (if any) that will be plotted at the
  119. point locations in the AutoCAD DXF file.  CONVERT reads the <CODE> field from
  120. the coordinate data file, then searches the data from the "CODES.DAT" file to
  121. find the AutoCAD layer and block names that correspond to that particular
  122. code.  The required format for the "CODES.DAT" file is as follows:
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.        C O N V E R T v1.2             Copyright (c) 1991 by -Mate Software
  130.  
  131.  
  132.  
  133.  
  134.  
  135.      FIELD         VALUE                   REQUIREMENTS
  136.      -----         -----                   ------------
  137.      Column   1-8: <CODE>                  (Required -- Integer value)
  138.      Column  9-23: <AUTOCAD LAYER NAME>    (Required -- Valid AutoCAD layer)
  139.      Column    24: <BLOCK SCALE FLAG>      (Optional -- "*")
  140.      Column 25-38: <AUTOCAD BLOCK NAME>    (Optional -- Valid AutoCAD block)
  141.      Column 39-80: <COMMENT>               (Optional -- Character/numeric)
  142.  
  143. <BLOCK SCALE FLAG> controls the scaling of the AutoCAD blocks that are
  144. inserted into the drawing.  If you wish to have the inserted blocks scaled
  145. based on the selected scale factor, you should leave this column blank.  If,
  146. however, you wish the block to be inserted at its actual size no matter what
  147. the scale of the drawing, you should add a asterisk (*) in this column.
  148. A typical "CODES.DAT" file is included in the archive or on the distribution
  149. diskette.
  150.  
  151.  
  152.  
  153. "ACAD.DWG" REQUIREMENTS:
  154. ------------------------
  155.  
  156. CONVERT generates an AutoCAD compatible DXF file when executed that contains
  157. the entity information necessary to create an AutoCAD points plot based on
  158. the information in the coordinate data file, the "CODES.DAT" file and the
  159. features file.  CONVERT ONLY generates the entity portion of the DXF file,
  160. and makes no attempt to generate the "LAYER" or "BLOCK" header sections of
  161. the DXF file.  Therefore, a base AutoCAD drawing (usually "ACAD.DWG") must be
  162. loaded prior to loading the CONVERT generated DXF file into AutoCAD.  The
  163. base drawing MUST contain all of the layer and block information referenced
  164. by the various codes in the coordinate data file, and the "CODES.DAT" file.
  165. An example "ACAD.DWG" file created with AutoCAD release 10 which includes all
  166. of the blocks and layers referenced in the example "CODES.DAT" file and the
  167. example coordinate data file is included in the archive or on the
  168. distribution diskette.
  169.  
  170.  
  171.  
  172. FEATURE LINE FILE REQUIREMENTS:
  173. -------------------------------
  174.  
  175. CONVERT will optionally generate feature lines on the DXF points plot if a
  176. feature line file is specified.  This file must consist of a list of points
  177. in sequential order included in the coordinate data file which are to be
  178. connected by feature lines.  Feature lines may be separated in the feature
  179. line file by entering a "ENDSTR" command instead of a point number after the
  180. last point in that particular feature line.  Required format for the file is
  181. one point number per line.  The feature line will be placed on the same layer
  182. as the second point in the feature line as specified in the "CODES.DAT" file.
  183. Each separate line entry in the features line file must contain at least two
  184. points, and may contain as many points as you desire.  There is no limit to
  185. the number of separate feature lines that you may specify.  An example
  186. feature line file is included in the archive or on the distribution diskette.
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.        C O N V E R T v1.2             Copyright (c) 1991 by -Mate Software
  196.  
  197.  
  198.  
  199.  
  200.  
  201. OUTPUT FILES GENERATED BY CONVERT:
  202. ----------------------------------
  203.  
  204. CONVERT generates two output files when executed.  The first is the AutoCAD
  205. compatible DXF file which will assume the file name of the coordinate data
  206. file name supplied as input with a ".DXF" extension.  The other is complete
  207. point listing including codes, AutoCAD layer names, and remarks.  This file
  208. is similarly named, but with a ".LST" extension.  These files will be
  209. generated in the same sub-directory as the input coordinate data file
  210. specified at the initial prompt.
  211.  
  212.  
  213.  
  214. QUESTIONS AND ADDITIONAL INFORMATION:
  215. -------------------------------------
  216.  
  217. All questions, comments, or additional information requests should be
  218. addressed to:
  219.  
  220.      Kurtis J. Jones
  221.      1748 North Oakland
  222.      Fayetteville, AR  72703
  223.  
  224. I may also be reached via The Spectrum BBS (501) 521-5639.
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.        C O N V E R T v1.2             Copyright (c) 1991 by -Mate Software
  262.  
  263.  
  264.  
  265.